<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--

  @(#)package.html	1.60 98/01/27

  Copyright 1998 Sun Microsystems, Inc. 901 San Antonio Road, 
  Palo Alto, California, 94303, U.S.A.  All Rights Reserved.

  This software is the confidential and proprietary information of Sun
  Microsystems, Inc. ("Confidential Information").  You shall not
  disclose such Confidential Information and shall use it only in
  accordance with the terms of the license agreement you entered into
  with Sun.

  CopyrightVersion 1.2

-->
</head>
<body bgcolor="white">
This package provides interface and implementations for validating 
input data within a JNDI mapper.

<h2>Specifications</h2>
<p>
This package provides a {@link Validator} interface for use by mappers 
to validate input fields, a basic regex-based implementation ({@link RegexValidator})
and some <em>Composite</em> based operators for complex rules. Validation 
rules are attached to a mapper but may be defined globally in a configuration 
file and shared between multiple sources.
</p>
<p>
Validation process at the source level is implemented in {@link fr.norsys.mapper.jndi.mappers.JNDIMapper#checkInput()}
method. This method simply applies a <em>Chain of Responsibility</em> pattern
and checks each validation rule in turn. The behavior is controlled 
by property <code>includeExclude</code> which tells what behavior
to apply:
<ul>
<li>Default to <em>invalidate</em>: if no validation rule matches (ie. replies
true to the {@link Validator#validate(java.util.Map,java.util.Map)} then input is not validated,</li>
<li>Default to <em>validate</em>: if no validation rule rejects input then 
input is validated.</li>
</ul>
</p>
<p>
By default, the JNDIMapper class validates anything and has its attribute <code>includeExclude</code>
set to {@link Validator#INCLUDE}.
</p>
<h2>Documentation</h2>

<ul>
  <li>see the <a href="/framwork-ldap/doc/config/jndi-configuration.dtd">DTD</a> 
	for JNDI configuration. </li>
</ul>

<!-- Put @see and @since tags down here. -->
@see java.util.regex.Pattern
</body>
</html> 